************************************************************************** (C) COPYRIGHT International Business Machines Corp. 1998,1999 All Rights Reserved. Licensed Materials - Property of IBM. ************************************************************************** FILE: README IBM MultiProtocol Switched Services Configuration Program MSS Client V1 R2.2 is a replacement for IBM MultiProtocol Switched Services Configuration Program MSS Client V1 R2.1. The Nways Multiprotocol Access, Routing, and Switched Services Configuration Program User's Guide is available separately (GC30-3830). Contents: 1. Readme and informational files 2. Installation Hardware and Software Requirements Obtaining the Configuration Program Electronically Procedure for Installing the Configuration Program 3. Starting the Configuration Program 4. Basic Guidelines for Using the Configuration Program 5. Sending/Retrieving the Configuration File 6. Problem Determination a. Panel Display Problems on AIX b. Known Problems on Windows 7. Restrictions ** For Windows users, please read the Known Problems on Windows under the Problem Determination section before you start the Configuration Program. 1. Readme and informational files Readme.txt - this file Release.txt - list of new functions in this release - restrictions for the release - any migration considerations from earlier releases Content.txt - one for every PTF in a given release, cumulative - a summary of whether the PTF introduces new function or is required to match a certain operational code PTF - for the GA level, the content document would refer to the release notes and state what Config Program PTF(s) in prior releases this covers - for every PTF, add at the top of the file the APARs that were added in this PTF 2. INSTALLATION Hardware and Software Requirements AIX a. RS/6000 Model 250/410 or better with minimum 80Mhz CPU b. 64 MB RAM (minimum) c. CD-ROM d. 54 MB free disk space. Additionally, you will need 1 to 3 MB for each configuration file. e. Graphics (1024 x 768 x 256 colors) display. f. 3-button mouse g. AIX for RS/6000 Version 4.1.5 or higher, AIXWindows, and Environment/6000. The Migration Tool, Conversion Program on AIX has special font requirements. You need to have /usr/lib/X11/fonts/75dpi/ in the list of directories. If you do not have this directory in your Xstation Font Path, then from your Xstation type: xset fp+ /usr/lib/X11/fonts/75dpi/ This will add the Conversion Program font directory to your Xstation Font Path. You may place the above line in your .profile for future use. OS/2 a. IBM PC-compatible with Intel Pentium ** 166 MHz or higher processor (See Note 1) b. 48 MB RAM (minimum) c. CD-ROM d. 37 MB free disk space. Additionally, you will need 1 to 3 MB for each configuration file. e. 10 MB for Swapper space f. SVGA (1024x768x256 colors) display. g. OS/2 3.0 or higher, IBM TCP/IP 1.2.1 for OS/2 or higher Microsoft Windows 95/98 or Windows NT a. IBM PC-compatible with Intel Pentium ** 166 MHz or higher processor (See Note 1) b. 48 MB RAM (minimum) c. CD-ROM d. 54 MB free disk space. Additionally, you will need 1 to 3 MB for each configuration file. e. SVGA (1024x768x256 colors) display. f. Microsoft Windows 95 or Windows NT. Notes: 1. More memory and better processors will improve the program's performance. 2. You must make sure that TCP/IP is installed and running before using the "Single Send or Retrieve" or "Multiple Send or Retrieve" functions. Obtaining the Configuration Program Electronically You can obtain the Configuration Program electronically, from http://www.networking.ibm.com/support/code.nsf/8270code Steps to obtain the Configuration Program electronically: 1. From the URL above, select Config Program MSS Client Version 2.2 2. Select the file from 'Files in this Package', at the bottom of the screen, in order to download the files. AIX 1. Download the INSTALLP file (approx. 27Meg) to a temporary directory. 2. To install the Configuration Program, change to the directory where the file you just downloaded is located. Proceed from step 5 in the Install on AIX section below. OS/2 1. Download the file (approx. 10Meg) to a temporary directory. 2. To install the Configuration Program, run the file you just downloaded in an OS/2 Command Window, follow the prompts that appear on the screen to complete the installation. Windows 1. Download the file (approx. 11.5Meg) to a temporary directory. 2. To install the Configuration Program, execute the self extracting file you just downloaded. Follow the prompts that appear on the screen to complete the installation. Procedure for Installing the Configuration Program Install on AIX 1. Log on as the "root" user 2. Insert the CD into your CD-ROM drive 3. Mount the CD-ROM. a. create directory /cdrom if one does not exist b. mount -v cdrfs -r /dev/cd0 /cdrom 4. Cd to the directory where the INSTALLP file is located. On the CD it will be in the /cdrom/config/aix/ directory. 5. Run SMIT and do the following: Note: The following steps are based on AIX 4.1.5. The steps are slightly different if you are using AIX 4.2 and later. a. Select "Software Installation and Maintenance." b. Select "Install and Update Software" c. Select "Install/Update Selectable Software (Custom Install)" d. Select "Install Software Products at Latest Level." e. Select "Install New Software Products at Latest Level." f. Enter the fully qualified filename of the INSTALLP file from the CD or the web. (Note that if you are in that directory already this becomes './mssc1r22'. g. Press PF4 to list the software and select the installation program. h. Select OK. j. Select OK. k. Select Done l. Select Cancel. 6. Unmount the CD-ROM unmount /cdrom 7. Exit root user. The Configuration Program was installed in the /usr/lpp/mssc1r22 directory. Install on OS/2 1. Insert the CD into your CD-ROM drive and change to the CD-ROM drive and the /config directory. 2. From an OS/2 Command Window, enter os2inst Follow the prompts that appear on the screen to complete the installation. Install on Windows 1. Insert the CD into your CD-ROM drive. If autoread is on, the installation program starts and presents an installation dialog. Otherwise, run setup from the /config/win directory on the CD-ROM. Follow the prompts that appear on the screen to complete the installation. 3. Starting the Configuration Program AIX 1. X-Windows must be running on the workstation. Enter xinit to start X-Windows, if not already started. 2. Change to the directory /usr/lpp/mssc1r22 which will contain the Configuration Program. 3. Type config and press ENTER. * For AIX users, if you experience panel distortion problems, please read the problem determination section for resolution. OS/2 1. Locate and open the Configuration Program folder. 2. Double-click on the Configuration Program icon to start the program. Windows 1. Select the Configuration Program under Windows, select Start->Programs->folder->MSSCV1R2.2 * For Windows users, please read Known Problems on Windows under the Problem Determination section before you start the Configuration Program. From the Navigation Window, under the Help pulldown, there is a Tutorial available to help a new user get familiar with using the Configuration Program. 4. Basic Guidelines for Using the Configuration Program This section is not a complete user's manual, but is intended to provide some common guidance in using the configuration program. After you start the configuration program and clear the copyright notice, you will see two windows: the left-hand window is the Navigation window and the right-hand window is the Configuration window. The Configuration Program is designed as a point-and-click interfaces. You select items from the Navigation Window and then fill in information on the Configuration Window. Guided Configuration This option opens a help window when the tool opens and changes to the appropriate help window as you change between selections on the navigation view. If you would rather not see this help you can turn it off by going to the Options->Guided Configuration Menu option from the main Menu bar. When you exit the tool this option will be saved in the cfg.ini file to be used the next time the tool is invoked. Using the Mouse The mouse is the main tool you use to move through the various lists and panels in the Configuration Program. Examples: . Left - to select an item in a panel . Right - On the Navigation Window - Display a pop-up menu for a selected item - You may select the 'Validate' option to display validation message(s) for an item with '?' next to it. On Notebook pages - You may select the 'Validate' option to display validation message(s) for all the notebook pages. F1 (Help) - to request help To obtain help on a panel: 1. Select an item in the Navigation Window. 2. Press F1. To obtain help on a parameter, a button, or a drop-down list: 1. Select the parameter field or button by tabbing to the field, button, or list. 2. Press F1. Extended Selection to delete multiple entries 1. Hold Left mouse button and Ctrl key simultaneously to select multiple entries on a list 2. Click on the Delete button on the panel Configuring Device Interfaces 1. From the Navigation Window, click on the '+' next to Devices or double clicking the left mouse button to expand the folder; then select Interfaces. 2. From the Device Interfaces panel, select an interface 3. To change Data link, select click on the Data link column of the selected interface, click on the pull-down menu to select the desired data link. To refresh the panel for the new data link, click the empty column next to the Data link. Configuring Interfaces Panels that have more than one columns 1. From one of the Interfaces panel, select the desired interface 2. Click on the column header of the feature you want to configure. 5. Sending/Retrieving the Configuration file Note: It helps to step through the Configuration Program as you read this. You MUST make sure that TCP/IP is installed and RUNNING before using the "Communications Single" and/or "Communications Multiple" functions. The Communications function will communicate with the router using the SNMP protocol. The router must be set up with an IP Address and have a SNMP community with access defined as WRITE_READ_TRAP for send and restart. For retrieve and query, the community access can be READ_TRAP or WRITE_READ_TRAP. The single send will send the configuration that is currently open. The IP destination and community fields will default to what is defined in the configuration. The timeout value is the maximum number of seconds the send function will wait for a response. Select the appropriate action(s): 1. Send the configuration to the router 2. Restart the router immediately or later 3. Send the configuration and then restart the router 4. Query the router for the System Description. 5. Retrieve the configuration from the router. For single router restart, the time initializes to the current time so the router will restart immediately. However the 'Date' and 'Time' fields can be changed to any date and time. For multiple router restart, the dates and times initialize to the last entered dates and times for each row in the selected send list. The 'All' button will apply the date and time specified in the 'Restart at' area to each row in the list. The 'Selected' button will only apply the date and time specified in the 'Restart at' area to the row selected. The date and time fields in the table may also be directly edited. If the Restart box is selected for a row and the date and time field are empty, the date and time will default to the date and time in the 'Restart at' area. Note: If the restart is sent to the router with a date and time earlier than the current date and time on the workstation (for example yesterday's date), the router will be restarted immediately. The delayed restart time is sent to the router in the form of seconds (xx). The router will restart at xx seconds from when he receives the packet (within a two minute window). Therefore if there are many hops to the destination or the network traffic is heavy, the router may restart later than expected. If a timeout error occurs, check that: 1. the IP Destination address is correct 2. there is a route to the IP address 3. the community exists 4. the timeout value is large enough 5. might be busy processing previous request NOTE: When a configuration is sent to the MSS Family Client switch, it needs approximately 40 seconds to load the configuration to the flash. During this time, the MSS Client Switch is not responding to the incoming SNMP request. If you requested both the send configuration and the restart router requests, the suggested timeout is minimum of 45 seconds. This timeout is necessary for the device to finish processing the send configuration request before responding to the restart device request. If an error with the SNMP packet occurs, check that: 1. the community has WRITE_READ_TRAP access 2. for multiple send, the configuration exists in the database Router configuration format(.cfg file readable by 8270) If you did not save ".csf" files using the previous versions of the Configuration Programs, you should find a copy of the Configuration Program which matches your router software to create ".csf" files. The Configuration Program checks the level of the configuration at the beginning of a READ ROUTER CONFIGURATION, and will terminate the read if the level of the configuration does not match the level of the Configuration Program. 6. Problem Determination The file, walkback.log is created when an internal execution error occurs in the program. The contents of this file should be given to IBM support when a problem with the Configuration program is reported. The configuration files in all formats available should also be given to IBM support to assist with problem determination. NOTE: The above mentioned file is written to the directory from which the Configuration Program was started. a). Panel Display Problems on AIX On AIX, there is a known panel distortion problem on lower resolution monitors. If panels look distorted, buttons (add, change, delete buttons) or fields appear missing, please reduce the font size set on your AIX system. How to change fonts on your AIX system From your AIX 'Common Desktop Environment', click the 'Style Manager' icon on your Front Panel. Click on 'Font', you will see a list of Relative font sizes available on your system. Change the font size to a smaller one, then restart the Configuration Program. b). Known Problems on Windows 1. Panel Display Problems on Windows On Windows, there is known panel distortion problem which might occur. If panels look distorted, fields, notebooks, and buttons appear missing, maximize that window, and then restore the window to its original size in order to correct the panel distortion. 2. There is a known problem in the Configuration Program that might occur due to placement of the Guided Configuration Help window in relation to the Configuration window. If the Guided Configuration help window overlays the entire Configuration window and the user selects another item in the Navigation window, the following error message might appear: "Runtime error: UndefinedObject does not understand setForeground: See the file walkback.log for more information. Do you wish to exit?" If this occurs, do the following: (1) Select "No" on the Error Message panel. This error does not effect accuracy or funcationality of the configuration Program If you select "Yes" as your response, the configuration Program will exit and terminate. (2) Position the Guided Configuration help window so that it DOES NOT overlay the entire Configuration window. You can do this by resizing and repositioning the Guided Configuration help window, or by turning Guided Configuration off by selecting Options->Guided Configuration in the Navigation window. 3. For Windows users who launch multiple versions of the Configuration Program, your help system might not function correctly unless your HELP path is set to include the current directory. Windows NT users: (1) Select Start->Settings->Control Panel (2) Select and double click the System Icon (3) Select the Environment Tab (4) Select HELP from the System Variable list (5) Add " .; " to the Value entry field in addition to what is already listed (Do not enter the quotation marks) (6) Click the Set Button Windows 95 users: (1) Add the following statement to either the Config.sys or Autoexec.bat files which exist on your system: SET HELP=.;%HELP% (2) Shutdown and Reboot your system for this change to take effect. 7. Restrictions. This section discusses some KEY considerations that users must be aware of when creating valid configurations. -You MUST make sure that TCP/IP is installed and RUNNING before using the "Communications Single" and/or "Communications Multiple" functions. On some platforms, the Configuration Program will hang if TCP/IP is not installed and running. -ELS (Event Logging System) data The Configuration Program does not support ELS configurations. Thus, if you want to configure ELS you must use the online configuration program on the router. When reading configurations from the router, the Configuration Program will preserve any ELS configuration done in the online configuration on the router and send it back on a subsequent send. Trademarks The following items are trademarks of the IBM Corporation in the United States or other countries of both: AIX RS/6000 Operating System/2 OS/2 Nways Microsoft, Windows, Windows NT, and the Windows 95 logo are trademarks or registered trademarks of Microsoft Corporation. Other company, product, and services names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. (C) Copyright IBM Corporation 1994,1999. All rights reserved.